클러스터 아키텍처와 컴포넌트

쿠버네티스 클러스터는 컨트롤 플레인(Control Plane)과 워커 노드(Worker Nodes)로 구성된 분산 시스템입니다.

컨트롤 플레인 컴포넌트

노드 컴포넌트

2026-10 갱신

v1.24에서 dockershim이 제거되어 kubelet은 Docker Engine을 직접 런타임으로 사용하지 않습니다. CRI 호환 런타임(containerd, CRI-O)을 사용하며, Docker Engine을 쓰려면 별도 어댑터인 cri-dockerd가 필요합니다.

클라우드 네트워크 개념과 비교

실습 예시

클러스터 구성요소 상태 확인

# 컨트롤 플레인 컴포넌트 상태 확인
kubectl get --raw='/readyz?verbose'
kubectl get pods -n kube-system

# 노드 상태 확인
kubectl get nodes
kubectl describe node <node-name>
2026-10 갱신

기존 예시의 kubectl get componentstatuses(kubectl get cs)는 v1.19부터 deprecated이며 etcd·scheduler·controller-manager 상태를 정확히 보여주지 않습니다. 대신 API 서버 헬스 엔드포인트(/readyz?verbose, /livez?verbose)와 kube-system 네임스페이스의 컨트롤 플레인 Pod 상태를 확인합니다.

시스템 Pod 확인

# kube-system 네임스페이스의 Pod 조회
kubectl get pods -n kube-system

중요 로그 확인

# API 서버 로그 확인 (kubeadm 클러스터 기준)
# Pod 이름은 kube-apiserver-<컨트롤 플레인 노드 이름> 형식입니다
kubectl get pods -n kube-system -l component=kube-apiserver
kubectl logs kube-apiserver-<node-name> -n kube-system

# kubelet 로그 확인 (노드에서 직접)
journalctl -u kubelet

고가용성 구성


관련 문서